<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>VMS::Filespec - convert between VMS and Unix file specification syntax - Perldoc Browser</title>
    <link rel="search" href="https://perldoc.perl.org/opensearch.xml" type="application/opensearchdescription+xml" title="Perldoc Browser">
    <link rel="canonical" href="https://perldoc.perl.org/VMS::Filespec">
    <link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.5.2/css/bootstrap.min.css" integrity="sha384-JcKb8q3iqJ61gNV9KGb8thSsNjpSL0n8PARn9HuZOnIxN0hoP+VmmDGMN5t9UJ0Z" crossorigin="anonymous">
    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/stackoverflow-light.min.css" integrity="sha512-cG1IdFxqipi3gqLmksLtuk13C+hBa57a6zpWxMeoY3Q9O6ooFxq50DayCdm0QrDgZjMUn23z/0PMZlgft7Yp5Q==" crossorigin="anonymous" />
    <style>
      body {
        background: #f4f4f5;
        color: #020202;
      }
      .navbar-dark {
        background-image: -webkit-linear-gradient(top, #005f85 0, #002e49 100%);
        background-image: -o-linear-gradient(top, #005f85 0, #002e49 100%);
        background-image: linear-gradient(to bottom, #005f85 0, #002e49 100%);
        filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff005f85', endColorstr='#ff002e49', GradientType=0);
        background-repeat: repeat-x;
      }
      .navbar-dark .navbar-nav .nav-link,
      .navbar-dark .navbar-nav .nav-link:focus { color: #fff }
      .navbar-dark .navbar-nav .nav-link:hover { color: #ffef68 }
      #wrapperlicious {
        margin: 0 auto;
        font: 0.9em 'Helvetica Neue', Helvetica, sans-serif;
        font-weight: normal;
        line-height: 1.5em;
        margin: 0;
        padding: 0;
      }
      #wrapperlicious h1 { font-size: 1.5em }
      #wrapperlicious h2 { font-size: 1.3em }
      #wrapperlicious h3 { font-size: 1.1em }
      #wrapperlicious h4 { font-size: 0.9em }
      #wrapperlicious h1, #wrapperlicious h2, #wrapperlicious h3,
      #wrapperlicious h4, #wrapperlicious dt {
        color: #020202;
        margin-top: 1em;
        margin-bottom: 1em;
        position: relative;
        font-weight: bold;
      }
      #wrapperlicious a { color: inherit; text-decoration: underline }
      #wrapperlicious #toc { text-decoration: none }
      #wrapperlicious a:hover { color: #2a2a2a }
      #wrapperlicious a img { border: 0 }
      #wrapperlicious :not(pre) > code {
        color: inherit;
        background-color: rgba(0, 0, 0, 0.04);
        border-radius: 3px;
        font: 0.9em Consolas, Menlo, Monaco, monospace;
        padding: 0.3em;
      }
      #wrapperlicious dd {
        margin: 0;
        margin-left: 2em;
      }
      #wrapperlicious dt {
        color: #2a2a2a;
        font-weight: bold;
        margin-left: 0.9em;
      }
      #wrapperlicious p {
        margin-bottom: 1em;
        margin-top: 1em;
      }
      #wrapperlicious li > p {
        margin-bottom: 0;
        margin-top: 0;
      }
      #wrapperlicious pre {
        border: 1px solid #c1c1c1;
        border-radius: 3px;
        font: 100% Consolas, Menlo, Monaco, monospace;
        margin-bottom: 1em;
        margin-top: 1em;
      }
      #wrapperlicious pre > code {
        display: block;
        background-color: #f6f6f6;
        font: 0.9em Consolas, Menlo, Monaco, monospace;
        line-height: 1.5em;
        text-align: left;
        white-space: pre;
        padding: 1em;
      }
      #wrapperlicious dl, #wrapperlicious ol, #wrapperlicious ul {
        margin-bottom: 1em;
        margin-top: 1em;
      }
      #wrapperlicious ul {
        list-style-type: square;
      }
      #wrapperlicious ul ul {
        margin-bottom: 0px;
        margin-top: 0px;
      }
      #footer {
        font-size: 0.8em;
        padding-top: 0.5em;
        text-align: center;
      }
      #more {
        display: inline;
        font-size: 0.8em;
      }
      #perldocdiv {
        background-color: #fff;
        border: 1px solid #c1c1c1;
        border-bottom-left-radius: 5px;
        border-bottom-right-radius: 5px;
        margin-left: auto;
        margin-right: auto;
        padding: 3em;
        padding-top: 1em;
        max-width: 960px;
      }
      #moduleversion { float: right }
      #wrapperlicious .leading-notice {
        font-style: italic;
        padding-left: 1em;
        margin-top: 1em;
        margin-bottom: 1em;
      }
      #wrapperlicious .permalink {
        display: none;
        left: -0.75em;
        position: absolute;
        padding-right: 0.25em;
        text-decoration: none;
      }
      #wrapperlicious h1:hover .permalink, #wrapperlicious h2:hover .permalink,
      #wrapperlicious h3:hover .permalink, #wrapperlicious h4:hover .permalink,
      #wrapperlicious dt:hover .permalink {
        display: block;
      }
    </style>
    <!-- Global site tag (gtag.js) - Google Analytics -->
    <script async src="https://www.googletagmanager.com/gtag/js?id=G-KVNWBNT5FB"></script>
    <script>
      window.dataLayer = window.dataLayer || [];
      function gtag(){dataLayer.push(arguments);}
      gtag('js', new Date());

      gtag('config', 'G-KVNWBNT5FB');
      gtag('config', 'UA-50555-3');
    </script>
  </head>
  <body>
    <nav class="navbar navbar-expand-md navbar-dark bg-dark justify-content-between">
  <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarNav" aria-controls="navbarNav" aria-expanded="false" aria-label="Toggle navigation">
    <span class="navbar-toggler-icon"></span>
  </button>
  <a class="navbar-brand" href="https://perldoc.perl.org/">Perldoc Browser</a>
  <div class="collapse navbar-collapse" id="navbarNav">
    <ul class="navbar-nav mr-auto">
      <li class="nav-item dropdown text-nowrap">
        <a class="nav-link dropdown-toggle" href="./VMS::Filespec.html#" id="dropdownlink-stable" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">5.35.0</a>
        <div class="dropdown-menu" aria-labelledby="dropdownlink-stable">
          <a class="dropdown-item" href="https://perldoc.perl.org/VMS::Filespec">Latest</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.38.2/VMS::Filespec">5.38.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.38.1/VMS::Filespec">5.38.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.38.0/VMS::Filespec">5.38.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.36.3/VMS::Filespec">5.36.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.36.2/VMS::Filespec">5.36.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.36.1/VMS::Filespec">5.36.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.36.0/VMS::Filespec">5.36.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.34.3/VMS::Filespec">5.34.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.34.2/VMS::Filespec">5.34.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.34.1/VMS::Filespec">5.34.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.34.0/VMS::Filespec">5.34.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.32.1/VMS::Filespec">5.32.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.32.0/VMS::Filespec">5.32.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.30.3/VMS::Filespec">5.30.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.30.2/VMS::Filespec">5.30.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.30.1/VMS::Filespec">5.30.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.30.0/VMS::Filespec">5.30.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.28.3/VMS::Filespec">5.28.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.28.2/VMS::Filespec">5.28.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.28.1/VMS::Filespec">5.28.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.28.0/VMS::Filespec">5.28.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.26.3/VMS::Filespec">5.26.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.26.2/VMS::Filespec">5.26.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.26.1/VMS::Filespec">5.26.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.26.0/VMS::Filespec">5.26.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.24.4/VMS::Filespec">5.24.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.24.3/VMS::Filespec">5.24.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.24.2/VMS::Filespec">5.24.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.24.1/VMS::Filespec">5.24.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.24.0/VMS::Filespec">5.24.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.22.4/VMS::Filespec">5.22.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.22.3/VMS::Filespec">5.22.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.22.2/VMS::Filespec">5.22.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.22.1/VMS::Filespec">5.22.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.22.0/VMS::Filespec">5.22.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.20.3/VMS::Filespec">5.20.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.20.2/VMS::Filespec">5.20.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.20.1/VMS::Filespec">5.20.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.20.0/VMS::Filespec">5.20.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.18.4/VMS::Filespec">5.18.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.18.3/VMS::Filespec">5.18.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.18.2/VMS::Filespec">5.18.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.18.1/VMS::Filespec">5.18.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.18.0/VMS::Filespec">5.18.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.16.3/VMS::Filespec">5.16.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.16.2/VMS::Filespec">5.16.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.16.1/VMS::Filespec">5.16.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.16.0/VMS::Filespec">5.16.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.14.4/VMS::Filespec">5.14.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.14.3/VMS::Filespec">5.14.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.14.2/VMS::Filespec">5.14.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.14.1/VMS::Filespec">5.14.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.14.0/VMS::Filespec">5.14.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.12.5/VMS::Filespec">5.12.5</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.12.4/VMS::Filespec">5.12.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.12.3/VMS::Filespec">5.12.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.12.2/VMS::Filespec">5.12.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.12.1/VMS::Filespec">5.12.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.12.0/VMS::Filespec">5.12.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.10.1/VMS::Filespec">5.10.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.10.0/VMS::Filespec">5.10.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.9/VMS::Filespec">5.8.9</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.8/VMS::Filespec">5.8.8</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.7/VMS::Filespec">5.8.7</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.6/VMS::Filespec">5.8.6</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.5/VMS::Filespec">5.8.5</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.4/VMS::Filespec">5.8.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.3/VMS::Filespec">5.8.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.2/VMS::Filespec">5.8.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.1/VMS::Filespec">5.8.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.0/VMS::Filespec">5.8.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.6.2/VMS::Filespec">5.6.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.6.1/VMS::Filespec">5.6.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.6.0/VMS::Filespec">5.6.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.005_04/VMS::Filespec">5.005_04</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.005_03/VMS::Filespec">5.005_03</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.005_02/VMS::Filespec">5.005_02</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.005_01/VMS::Filespec">5.005_01</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.005/VMS::Filespec">5.005</a>
        </div>
      </li>
      <li class="nav-item dropdown text-nowrap">
        <a class="nav-link dropdown-toggle" href="./VMS::Filespec.html#" id="dropdownlink-dev" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">Dev</a>
        <div class="dropdown-menu" aria-labelledby="dropdownlink-dev">
          <a class="dropdown-item" href="https://perldoc.perl.org/blead/VMS::Filespec">blead</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.39.6/VMS::Filespec">5.39.6</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.39.5/VMS::Filespec">5.39.5</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.39.4/VMS::Filespec">5.39.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.39.3/VMS::Filespec">5.39.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.39.2/VMS::Filespec">5.39.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.39.1/VMS::Filespec">5.39.1</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.38.0-RC2/VMS::Filespec">5.38.0-RC2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.38.0-RC1/VMS::Filespec">5.38.0-RC1</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.11/VMS::Filespec">5.37.11</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.10/VMS::Filespec">5.37.10</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.9/VMS::Filespec">5.37.9</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.8/VMS::Filespec">5.37.8</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.7/VMS::Filespec">5.37.7</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.6/VMS::Filespec">5.37.6</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.5/VMS::Filespec">5.37.5</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.4/VMS::Filespec">5.37.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.3/VMS::Filespec">5.37.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.2/VMS::Filespec">5.37.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.1/VMS::Filespec">5.37.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.0/VMS::Filespec">5.37.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.11/VMS::Filespec">5.35.11</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.10/VMS::Filespec">5.35.10</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.9/VMS::Filespec">5.35.9</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.8/VMS::Filespec">5.35.8</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.7/VMS::Filespec">5.35.7</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.6/VMS::Filespec">5.35.6</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.5/VMS::Filespec">5.35.5</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.4/VMS::Filespec">5.35.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.3/VMS::Filespec">5.35.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.2/VMS::Filespec">5.35.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.1/VMS::Filespec">5.35.1</a>
          <a class="dropdown-item active" href="./VMS::Filespec.html">5.35.0</a>
        </div>
      </li>
      <li class="nav-item dropdown text-nowrap">
        <a class="nav-link dropdown-toggle" href="./VMS::Filespec.html#" id="dropdownlink-nav" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">Documentation</a>
        <div class="dropdown-menu" aria-labelledby="dropdownlink-nav">
          <a class="dropdown-item" href="perl.html">Perl</a>
          <a class="dropdown-item" href="perlintro.html">Intro</a>
          <a class="dropdown-item" href="perl.html#Tutorials">Tutorials</a>
          <a class="dropdown-item" href="perlfaq.html">FAQs</a>
          <a class="dropdown-item" href="perl.html#Reference-Manual">Reference</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="perlop.html">Operators</a>
          <a class="dropdown-item" href="functions.html">Functions</a>
          <a class="dropdown-item" href="variables.html">Variables</a>
          <a class="dropdown-item" href="modules.html">Modules</a>
          <a class="dropdown-item" href="perlutil.html">Utilities</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="perlcommunity.html">Community</a>
          <a class="dropdown-item" href="perlhist.html">History</a>
        </div>
      </li>
    </ul>
    <ul class="navbar-nav">
      <script>
        function set_expand (expand) {
          var perldocdiv = document.getElementById('perldocdiv');
          var width = window.getComputedStyle(perldocdiv).getPropertyValue('max-width');
          var expanded = (width == '' || width == 'none') ? true : false;
          if (expand === null) {
            expand = !expanded;
          }
          if ((expand && !expanded) || (!expand && expanded)) {
            perldocdiv.style.setProperty('max-width', expand ? 'none' : '960px');
            var button_classlist = document.getElementById('content-expand-button').classList;
            if (expand) {
              button_classlist.add('btn-light');
              button_classlist.remove('btn-outline-light');
            } else {
              button_classlist.add('btn-outline-light');
              button_classlist.remove('btn-light');
            }
          }
          return expand;
        }
        function toggle_expand () {
          var expand = set_expand(null);
          document.cookie = 'perldoc_expand=' + (expand ? 1 : 0) + '; path=/; expires=Tue, 19 Jan 2038 03:14:07 UTC';
        }
        function read_expand () {
          return document.cookie.split(';').some(function (item) { return item.indexOf('perldoc_expand=1') >= 0 });
        }
        if (document.readyState === 'loading') {
          document.addEventListener('DOMContentLoaded', function () {
            if (read_expand()) {
              set_expand(true);
            }
          });
        } else if (read_expand()) {
          set_expand(true);
        }
      </script>
      <button id="content-expand-button" type="button" class="btn btn-outline-light d-none d-lg-inline-block mr-2" onclick="toggle_expand()">Expand</button>
    <ul>
    <form class="form-inline" method="get" action="https://perldoc.perl.org/5.35.0/search">
      <input class="form-control mr-3" type="search" name="q" placeholder="Search" aria-label="Search">
    </form>
  </div>
</nav>

    <div id="wrapperlicious" class="container-fluid">
      <div id="perldocdiv">
        <div id="links">
          <a href="./VMS::Filespec.html">VMS::Filespec</a>
          <div id="more">
            (<a href="./VMS::Filespec.txt">source</a>,
            <a href="https://metacpan.org/pod/VMS::Filespec">CPAN</a>)
          </div>
            <div id="moduleversion">version 1.12</div>
        </div>
        <div class="leading-notice">
          You are viewing the version of this documentation from Perl 5.35.0.
            This is a development version of Perl.
        </div>
        <h1><a id="toc">CONTENTS</a></h1>
                  <ul>
              <li>
                <a class="text-decoration-none" href="./VMS::Filespec.html#NAME">NAME</a>
              </li>
              <li>
                <a class="text-decoration-none" href="./VMS::Filespec.html#SYNOPSIS">SYNOPSIS</a>
              </li>
              <li>
                <a class="text-decoration-none" href="./VMS::Filespec.html#DESCRIPTION">DESCRIPTION</a>
                            <ul>
              <li>
                <a class="text-decoration-none" href="./VMS::Filespec.html#rmsexpand">rmsexpand</a>
              </li>
              <li>
                <a class="text-decoration-none" href="./VMS::Filespec.html#vmsify">vmsify</a>
              </li>
              <li>
                <a class="text-decoration-none" href="./VMS::Filespec.html#unixify">unixify</a>
              </li>
              <li>
                <a class="text-decoration-none" href="./VMS::Filespec.html#pathify">pathify</a>
              </li>
              <li>
                <a class="text-decoration-none" href="./VMS::Filespec.html#fileify">fileify</a>
              </li>
              <li>
                <a class="text-decoration-none" href="./VMS::Filespec.html#vmspath">vmspath</a>
              </li>
              <li>
                <a class="text-decoration-none" href="./VMS::Filespec.html#unixpath">unixpath</a>
              </li>
              <li>
                <a class="text-decoration-none" href="./VMS::Filespec.html#candelete">candelete</a>
              </li>
              <li>
                <a class="text-decoration-none" href="./VMS::Filespec.html#case_tolerant_process">case_tolerant_process</a>
              </li>
              <li>
                <a class="text-decoration-none" href="./VMS::Filespec.html#unixrealpath">unixrealpath</a>
              </li>
              <li>
                <a class="text-decoration-none" href="./VMS::Filespec.html#vmsrealpath">vmsrealpath</a>
              </li>
          </ul>

              </li>
              <li>
                <a class="text-decoration-none" href="./VMS::Filespec.html#REVISION">REVISION</a>
              </li>
          </ul>

      <h1 id="NAME"><a class="permalink" href="./VMS::Filespec.html#NAME">#</a>NAME</h1>

<p>VMS::Filespec - convert between VMS and Unix file specification syntax</p>

<h1 id="SYNOPSIS"><a class="permalink" href="./VMS::Filespec.html#SYNOPSIS">#</a>SYNOPSIS</h1>

<pre><code>use VMS::Filespec;
$fullspec = rmsexpand(&#39;[.VMS]file.specification&#39;[, &#39;default:[file.spec]&#39;]);
$vmsspec = vmsify(&#39;/my/Unix/file/specification&#39;);
$unixspec = unixify(&#39;my:[VMS]file.specification&#39;);
$path = pathify(&#39;my:[VMS.or.Unix.directory]specification.dir&#39;);
$dirfile = fileify(&#39;my:[VMS.or.Unix.directory.specification]&#39;);
$vmsdir = vmspath(&#39;my/VMS/or/Unix/directory/specification.dir&#39;);
$unixdir = unixpath(&#39;my:[VMS.or.Unix.directory]specification.dir&#39;);
candelete(&#39;my:[VMS.or.Unix]file.specification&#39;);
$case_tolerant = case_tolerant_process;
$unixspec = unixrealpath(&#39;file_specification&#39;);
$vmsspec = vmsrealpath(&#39;file_specification&#39;);</code></pre>

<h1 id="DESCRIPTION"><a class="permalink" href="./VMS::Filespec.html#DESCRIPTION">#</a>DESCRIPTION</h1>

<p>This package provides routines to simplify conversion between VMS and Unix syntax when processing file specifications. This is useful when porting scripts designed to run under either OS, and also allows you to take advantage of conveniences provided by either syntax (<i>e.g.</i> ability to easily concatenate Unix-style specifications). In addition, it provides an additional file test routine, <code>candelete</code>, which determines whether you have delete access to a file.</p>

<p>If you&#39;re running under VMS, the routines in this package are special, in that they&#39;re automatically made available to any Perl script, whether you&#39;re running <i>miniperl</i> or the full <i>perl</i>. The <code>use VMS::Filespec</code> or <code>require VMS::Filespec; import VMS::Filespec ...</code> statement can be used to import the function names into the current package, but they&#39;re always available if you use the fully qualified name, whether or not you&#39;ve mentioned the <i>.pm</i> file in your script. If you&#39;re running under another OS and have installed this package, it behaves like a normal Perl extension (in fact, you&#39;re using Perl substitutes to emulate the necessary VMS system calls).</p>

<p>Each of these routines accepts a file specification in either VMS or Unix syntax, and returns the converted file specification, or <code>undef</code> if an error occurs. The conversions are, for the most part, simply string manipulations; the routines do not check the details of syntax (e.g. that only legal characters are used). There is one exception: when running under VMS, conversions from VMS syntax use the $PARSE service to expand specifications, so illegal syntax, or a relative directory specification which extends above the tope of the current directory path (e.g [---.foo] when in dev:[dir.sub]) will cause errors. In general, any legal file specification will be converted properly, but garbage input tends to produce garbage output.</p>

<p>Each of these routines is prototyped as taking a single scalar argument, so you can use them as unary operators in complex expressions (as long as you don&#39;t use the <code>&amp;</code> form of subroutine call, which bypasses prototype checking).</p>

<p>The routines provided are:</p>

<h2 id="rmsexpand"><a class="permalink" href="./VMS::Filespec.html#rmsexpand">#</a>rmsexpand</h2>

<p>Uses the RMS $PARSE and $SEARCH services to expand the input specification to its fully qualified form, except that a null type or version is not added unless it was present in either the original file specification or the default specification passed to <code>rmsexpand</code>. (If the file does not exist, the input specification is expanded as much as possible.) If an error occurs, returns <code>undef</code> and sets <code>$!</code> and <code>$^E</code>.</p>

<p><code>rmsexpand</code> on success will produce a name that fits in a 255 byte buffer, which is required for parameters passed to the DCL interpreter.</p>

<h2 id="vmsify"><a class="permalink" href="./VMS::Filespec.html#vmsify">#</a>vmsify</h2>

<p>Converts a file specification to VMS syntax. If the file specification cannot be converted to or is already in VMS syntax, it will be passed through unchanged.</p>

<p>The file specifications of <code>.</code> and <code>..</code> will be converted to <code>[]</code> and <code>[-]</code>.</p>

<p>If the file specification is already in a valid VMS syntax, it will be passed through unchanged, except that the UTF-8 flag will be cleared since VMS format file specifications are never in UTF-8.</p>

<p>When Perl is running on an OpenVMS system, if the <code>DECC$EFS_CHARSET</code> feature is not enabled, extra dots in the file specification will be converted to underscore characters, and the <code>?</code> character will be converted to a <code>%</code> character, if a conversion is done.</p>

<p>When Perl is running on an OpenVMS system, if the <code>DECC$EFS_CHARSET</code> feature is enabled, this implies that the Unix pathname cannot have a version, and that a path consisting of three dots, <code>./.../</code>, will be converted to <code>[.^.^.^.]</code>.</p>

<p>Unix style shell macros like <code>$(abcd)</code> are passed through instead of being converted to <code>$^(abcd^)</code> independent of the <code>DECC$EFS_CHARSET</code> feature setting. Unix style shell macros should not use characters that are not in the ASCII character set, as the resulting specification may or may not be still in UTF8 format.</p>

<p>The feature logical name <code>PERL_VMS_VTF7_FILENAMES</code> controls if UNICODE characters in Unix filenames are encoded in VTF-7 notation in the resulting OpenVMS file specification. [Currently under development]</p>

<p><code>unixify</code> on the resulting file specification may not result in the original Unix file specification, so programs should not plan to convert a file specification from Unix to VMS and then back to Unix again after modification of the components.</p>

<h2 id="unixify"><a class="permalink" href="./VMS::Filespec.html#unixify">#</a>unixify</h2>

<p>Converts a file specification to Unix syntax. If the file specification cannot be converted to or is already in Unix syntax, it will be passed through unchanged.</p>

<p>When Perl is running on an OpenVMS system, the following <code>DECC$</code> feature settings will control how the filename is converted:</p>

<pre><code>C&lt;decc$disable_to_vms_logname_translation:&gt; default = C&lt;ENABLE&gt;
C&lt;decc$disable_posix_root:&gt;                 default = C&lt;ENABLE&gt;
C&lt;decc$efs_charset:&gt;                        default = C&lt;DISABLE&gt;
C&lt;decc$filename_unix_no_version:&gt;           default = C&lt;DISABLE&gt;
C&lt;decc$readdir_dropdotnotype:&gt;              default = C&lt;ENABLE&gt;</code></pre>

<p>When Perl is being run under a Unix shell on OpenVMS, the defaults at a future time may be more appropriate for it.</p>

<p>When Perl is running on an OpenVMS system with <code>DECC$EFS_CHARSET</code> enabled, a wild card directory name of <code>[...]</code> cannot be translated to a valid Unix file specification. Also, directory file specifications will have their implied &quot;.dir;1&quot; removed, and a trailing <code>.</code> character indicating a null extension will be removed.</p>

<p>Note that <code>DECC$EFS_CHARSET</code> requires <code>DECC$FILENAME_UNIX_NO_VERSION</code> because the conversion routine cannot differentiate whether the last <code>.</code> of a Unix specification is delimiting a version, or is just part of a file specification.</p>

<p><code>vmsify</code> on the resulting file specification may not result in the original VMS file specification, so programs should not plan to convert a file specification from VMS to Unix and then back to VMS again after modification.</p>

<h2 id="pathify"><a class="permalink" href="./VMS::Filespec.html#pathify">#</a>pathify</h2>

<p>Converts a directory specification to a path - that is, a string you can prepend to a file name to form a valid file specification. If the input file specification uses VMS syntax, the returned path does, too; likewise for Unix syntax (Unix paths are guaranteed to end with &#39;/&#39;). Note that this routine will insist that the input be a legal directory file specification; the file type and version, if specified, must be <i>.DIR;1</i>. For compatibility with Unix usage, the type and version may also be omitted.</p>

<h2 id="fileify"><a class="permalink" href="./VMS::Filespec.html#fileify">#</a>fileify</h2>

<p>Converts a directory specification to the file specification of the directory file - that is, a string you can pass to functions like <code>stat</code> or <code>rmdir</code> to manipulate the directory file. If the input directory specification uses VMS syntax, the returned file specification does, too; likewise for Unix syntax. As with <code>pathify</code>, the input file specification must have a type and version of <i>.DIR;1</i>, or the type and version must be omitted.</p>

<h2 id="vmspath"><a class="permalink" href="./VMS::Filespec.html#vmspath">#</a>vmspath</h2>

<p>Acts like <code>pathify</code>, but insures the returned path uses VMS syntax.</p>

<h2 id="unixpath"><a class="permalink" href="./VMS::Filespec.html#unixpath">#</a>unixpath</h2>

<p>Acts like <code>pathify</code>, but insures the returned path uses Unix syntax.</p>

<h2 id="candelete"><a class="permalink" href="./VMS::Filespec.html#candelete">#</a>candelete</h2>

<p>Determines whether you have delete access to a file. If you do, <code>candelete</code> returns true. If you don&#39;t, or its argument isn&#39;t a legal file specification, <code>candelete</code> returns FALSE. Unlike other file tests, the argument to <code>candelete</code> must be a file name (not a FileHandle), and, since it&#39;s an XSUB, it&#39;s a list operator, so you need to be careful about parentheses. Both of these restrictions may be removed in the future if the functionality of <code>candelete</code> becomes part of the Perl core.</p>

<h2 id="case_tolerant_process"><a class="permalink" href="./VMS::Filespec.html#case_tolerant_process">#</a>case_tolerant_process</h2>

<p>This reports whether the VMS process has been set to a case tolerant state, and returns true when the process is in the traditional case tolerant mode and false when case sensitivity has been enabled for the process. It is intended for use by the File::Spec::VMS-&gt;case_tolerant method only, and it is recommended that you only use File::Spec-&gt;case_tolerant.</p>

<h2 id="unixrealpath"><a class="permalink" href="./VMS::Filespec.html#unixrealpath">#</a>unixrealpath</h2>

<p>This exposes the VMS C library <code>realpath</code> function where available. It will always return a Unix format specification.</p>

<p>If the <code>realpath</code> function is not available, or is unable to return the real path of the file, <code>unixrealpath</code> will use the same internal procedure as the <code>vmsrealpath</code> function and convert the output to a Unix format specification. It is not available on non-VMS systems.</p>

<h2 id="vmsrealpath"><a class="permalink" href="./VMS::Filespec.html#vmsrealpath">#</a>vmsrealpath</h2>

<p>This uses the <code>LIB$FID_TO_NAME</code> run-time library call to find the name of the primary link to a file, and returns the filename in VMS format. This function is not available on non-VMS systems.</p>

<h1 id="REVISION"><a class="permalink" href="./VMS::Filespec.html#REVISION">#</a>REVISION</h1>

<p>This document was last revised 8-DEC-2007, for Perl 5.10.0</p>


      </div>
      <div id="footer">
        <p>Perldoc Browser is maintained by Dan Book (<a href="https://metacpan.org/author/DBOOK">DBOOK</a>). Please contact him via the <a href="https://github.com/Grinnz/perldoc-browser/issues">GitHub issue tracker</a> or <a href="mailto:dbook@cpan.org">email</a> regarding any issues with the site itself, search, or rendering of documentation.</p>

<p>The Perl documentation is maintained by the Perl 5 Porters in the development of Perl. Please contact them via the <a href="https://github.com/Perl/perl5/issues">Perl issue tracker</a>, the <a href="https://lists.perl.org/list/perl5-porters.html">mailing list</a>, or <a href="https://kiwiirc.com/client/irc.perl.org/p5p">IRC</a> to report any issues with the contents or format of the documentation.</p>


      </div>
    </div>
    <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.5.1/jquery.slim.min.js" integrity="sha512-/DXTXr6nQodMUiq+IUJYCt2PPOUjrHJ9wFrqpJ3XkgPNOZVfMok7cRw6CSxyCQxXn6ozlESsSh1/sMCTF1rL/g==" crossorigin="anonymous"></script>
    <script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.16.1/umd/popper.min.js" integrity="sha512-ubuT8Z88WxezgSqf3RLuNi5lmjstiJcyezx34yIU2gAHonIi27Na7atqzUZCOoY4CExaoFumzOsFQ2Ch+I/HCw==" crossorigin="anonymous"></script>
    <script src="https://stackpath.bootstrapcdn.com/bootstrap/4.5.2/js/bootstrap.min.js" integrity="sha384-B4gt1jrGC7Jh4AgTPSdUtOBvfO8shuf57BaghqFfPlYxofvL8/KUEfYiJOMMV+rV" crossorigin="anonymous"></script>
    <script src="../highlight.pack.js"></script>
    <script>hljs.highlightAll();</script>
  </body>
</html>
